home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 7 / PC World Interactive 7.iso / program / vbkontrol.exe / VBDLL15D.ZIP / RELNOTES.TX_ / RELNOTES.TX
Text File  |  1995-03-09  |  6KB  |  123 lines
  1. Release Notes for VB/DLL.  The Visual Basic library builder.
  2.  
  3. 1.5 - Existing library programs will have to be re-built before they will 
  4. work with this version.  Future versions of the product will be 
  5. backwardly compatible to libraries built with this version.
  6.  
  7. 1)  Multiple functions can now be exported from a single instance of 
  8. the control.  Functions declarations are no longer defined using the 
  9. VB properties window.  The Edit Declarations dialog in the Library 
  10. Manager program is now set up to do this.  It's executed by either 
  11. clicking the right mouse button on a control or by clicking the '...' box 
  12. on the Edit Declarations property.  The ShowCode property has been 
  13. eliminated.  This can now be done using the "Show Code" button in the 
  14. Library Manager program.  Because of this change,  an additional  
  15. string parameter indicating the function name executed must now be 
  16. passed to the Call_Proc event procedure.  See item 2 in the 1.25 
  17. section for instructions on updating your CallProc event procedures to 
  18. accept the new parameter.  The total size of all the function 
  19. declarations for a control instance cannot exceed 64K.
  20.  
  21. 2)  The FireUnloadEvent property and the UnloadLibrary event no 
  22. longer exist.  Instead,  library programs can now export a function 
  23. called "UnloadVbLib" that will be called when all the callers unload.  
  24. This allows libraries to be unloaded by any program.  The function 
  25. must be defined as accepting one integer parameter.  This parameter 
  26. indicates whether or not the library program was started by the VBX 
  27. control.  It will be either 0 or -1. If False,  then it may have been 
  28. started directly by a user and probably shouldn't be shut down.  
  29. Because of the missing FireUnloadEvent property,  forms with 
  30. VBDLLCTL controls that were built with a previous version will 
  31. generate errors when they're loaded.  These can be ignored.  Also,  any 
  32. code for a VBDLLCTL control that was in the UnloadLibrary event 
  33. will now be in a general procedure for the form the control was in.  
  34. This is because the event no longer exists.  Usually,  this code will be 
  35. moved to the "UnloadVbLib" function and these procedures deleted.
  36.  
  37. 3)  VB/DLL functions can now accept VB variant data types.  For now,  
  38. variant parameters must be declared As Variant in the Edit 
  39. Declarations Dialog and cannot simply omit a type declaration 
  40. character as is done in VB to indicate a variant type variable.  This will 
  41. be remedied in the complete,  non-demo 1.5 version.
  42.  
  43. 4)  Two new stub functions for CopyParmsToVB and 
  44. CopyParmsFromVB provide "variable number of parameters" support 
  45. in the same fashion as VBFunction.  They're called VCopyParmsToVB 
  46. and VCopyParmsFromVB.  The ShowCode window now generates the 
  47. VB Declares for these as well as the VBFunction function.  See the 
  48. on-line help for how to use.
  49.  
  50. 5)  The VBFunction function now displays VB/DLL errors in standard 
  51. VB run time error message boxes instead of creating a "Bad DLL 
  52. Calling Convention" error.
  53.  
  54. 6)  Right button mouse support has been added for design-time 
  55. instances of the control.  Clicking the right button on a control 
  56. instance will activate the Edit Declarations Dialog.
  57.  
  58.  
  59. 1.25
  60.  
  61. 1)  The VB parameter type String * Length is now supported for 
  62. library functions,  indicating that a buffer of a specific length will be 
  63. passed.  This is mainly for C/Pascal callers.
  64. 2)  The UnloadLibrary event now gets a parameter that indicates 
  65. whether or not the library program was started by the VBX control.  If 
  66. it wasn't,  then it may have been started directly by a user and probably 
  67. shouldn't be shut down.  If a library program using a previous version 
  68. of VB/DLL has code in this event,  the code will have to be cut out,  
  69. the function deleted and the code pasted back in.  This will make the 
  70. new parameter appear.
  71. 3)  A bug has been fixed that causes a General Protection Fault when 
  72. calling library functions that return a non-string value declared with a 
  73. type phrase in the Declaration property instead of a type character (e.g  
  74. ShowForm () As Integer instead of ShowForm% ().)
  75. 4)  A new DLL function called VBFunction is exported from the VBX.  
  76. Its purpose is to call VB/DLL library functions just like 
  77. VBFunctionCall.  The difference is that VBFunction can accept the 
  78. function parameters on the stack eliminating the need for Type...End 
  79. Type structures in the caller program.  When things go wrong though,  
  80. (like the function is not found)  the caller will generally get a "Bad 
  81. DLL Calling Convention" error instead of the normal codes passed 
  82. back from VBFunctionCall.  Look at the samples to see how this new 
  83. function is used.
  84.  
  85.  
  86.  
  87. 1.2
  88.  
  89. 1)  The ShowCode application is now called the Library Manager and 
  90. has the capability to display loaded library programs and functions.
  91.  
  92. 2)   DLL files CLIENT.DLL and VBDLL.DLL,  as well as the 
  93. SpyWorks/VB files SBC.VBX and DWSPYDLL.DLL are no longer 
  94. required.  VBRUN300.DLL is still needed to run the Library Manager 
  95. application but it doesn't need to be re-distributed.  As a result the 
  96. Library Builder takes up only about 30K of RAM when loaded.  The 
  97. files for re-distribution are now VBDLLCTL.VBX and 
  98. DLLCTRL.EXE.
  99.  
  100. 3)   Parameter space for library function return values is no longer 
  101. automatically allocated.  Space for the function return value must now 
  102. be allocated by the caller and passed as parameter 3 to 
  103. VBFunctionCall.  If no return value is desired,  a 0 (NULL pointer)  
  104. can be passed.  This is a preliminary step to supporting user defined 
  105. data types.
  106.  
  107. 1.0
  108.  
  109. 1)   If the called library function yields processing to Windows,  the 
  110. VBFunctionCall function may  time-out and return with an error.  
  111. Yielding to Windows occurs when the library function executes a 
  112. DoEvents statement,  stops at a breakpoint,  shows a modal form,  or 
  113. calls one of the Windows API functions that yield like GetMessage,  
  114. PeekMessage,  WaitMessage  etc.
  115.  
  116. 2)   VB/DLL libraries do not support ByVal parameter passing.
  117.  
  118. 3)   The library application's title as entered in the Make Exe dialog 
  119. should  match the EXE name the caller passes into the 
  120. VBFunctionCall function.  This ensures that the library manager can 
  121. locate a library that is loaded. in the Visual Basic environment.
  122.  
  123.